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Introduction 


Overview 

Mapmaker is an easy-to-use utility to help you create multiscreen displays using 
redefined, BASIC Graphics mode 2 characters. To create a map, you first define the 
dimensions of the total display area, and then you enter characters from the computer 
keyboard. Mapmaker acts as an easel upon which you can try out different combinations 
of shapes by displaying them on the screen. The program's fine scrolling feature allows 
smooth movement from one part of your map to another by using either a Joystick 
Controller or the directional arrows on the computer keyboard. Mapmaker comes with 
an all-purpose character set of map elements. However, you can use a separate 
character editor to create your own mapping characters and then produce an infinite 
variety of displays with Mapmaker. The program supports four character colors, plus a 
background color, and the package contains an easy-to-use facility for changing the 
playfield color registers. When you complete a map, the program saves your file on 
diskette. 

Required accessories 

• 32K RAM 

• ATARI 810 Disk Drive 

• ATARI BASIC Language Cartridge 


Optional accessories 

• Instedit (APX-10060 or APX-20060) or other compatible character set editor 

• One ATARI Joystick Controller 


Using Mapmaker with other programs 

Mapmaker is written in ATARI BASIC, with liberal use of machine language routines 
accessed by the USR function. In particular, Mapmaker uses page six of memory. 
Therefore, don’t use Mapmaker with another program using page six. (If you're not 
familiar with the concept of pages in memory, you probably have nothing to worry about.) 
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Getting started 


Duplicating the files onto another diskette 

Mapmaker \s disk-based, and uses or creates four separate diskette files in the process 
of creating a screen display. For this reason, you need to copy the files 
MAPMAKER. BAS and SCROLL.OBJ onto another diskette before using the program. 
First-time users should duplicate the entire diskette to transfer the character set file 
(ALLPRPS.SET) and the demonstration file (DEMO.MAP) along with the program files. 


Loading Mapmaker into computer memory 

1. Insert the ATARI BASIC Language Cartridge in the cartridge slot of your computer. 

2. If you plan to use the Joystick Controller, plug it into the first controller jack of 
your computer console. 

3. Turn on your disk drive. 

4. When the BUSY light goes out, open the disk drive door and insert the Mapmaker 
diskette with the label in the lower right-hand corner nearest to you. 

5. Turn on your computer and your TV set. 

6. When the READY prompt displays on your TV screen, type 

RUN "D:MAPMAKER.BAS" 

and press the RETURN key. The screen will clear, and then the message 
PROGRAM INITIALIZATION 

displays. The computer will access the diskette several times. 

7. If this is your first look at Mapmaker, no messages relating to character set files will 
display. Later, when you have more than one character set file on diskette, the 
program will ask you which character set you want to load. When only one character 
set is on the diskette, the program loads it automatically. 

8. Then the prompt 


Create a neu map > or 
Load an existing map? 

displays. Type C to create a new map or L to load an existing one into memory. 

(Note. If you’re a new user of Mapmaker, go to the next section, titled “Demonstrating 
Mapmaker", at this point.) 
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Responding L tells the computer to scan the diskette for MAP files. If it finds just one, it 
loads the file automatically. If it finds two or more, the program asks you which file you 
want to load. 

Mapmaker then loads in your specified file and goes into EDIT mode. 

Responding C tells the computer to set up memory for a new map. The program asks 
you for the dimensions of the display area, measured in characters. Width can range 
from 22 to 128 characters and must be an even number (odd numbers are automatically 
rounded down). Height can range from 13 to 255 characters. The only other limitation on 
height is that it can't exceed a value which, when multiplied by width, equals more than 
4K (4096 bytes). On systems with 40K or more of computer memory, the maximum 
display area is 8K (8192 bytes). The computer will substitute legal values for any values 
entered that aren’t within the acceptable ranges. If these legal values aren't adequate for 
your purposes, reconsider the layout of your map project. 

Upon receiving the display dimensions, the program switches to the display and draws a 
border around it. Mapmaker loads in the scrolling routine from diskette and then goes 
into EDIT mode. 



Demonstrating Mapmaker 


Loading in the demonstration map 

Be sure you duplicate all the Mapmaker files onto another diskette before proceeding. 
Then, following the instructions in “Getting Started” up to step 8, you should now be 
looking at the screen displaying the messages “PROGRAM INITIALIZATION” and 
“Create a new map, or Load an existing map?" At this point, press the “L” key to instruct 
Mapmaker to load a MAP file from diskette that demonstrates a map created with 
Mapmaker. The program then automatically loads and displays the DEMO.MAP. The 
upper left corner of the map fills the screen, and the entire map is read into display areas 
not currently visible. Next, Mapmaker reads in a machine language file (named 
SCROLL.OBJ) containing the fine scrolling routine. A cursor is blinking in the upper left 
corner of the display. The lower right of the screen contains a set of X and Y coordinates 
and the status of the I (INVERSE video) flag, which is currently OFF. The current cursor 
coordinates are 0,0. 

Moving around the display 

First we’ll move the cursor. If you want to use the Joystick Controller to move the cursor 
across the display, move the joystick in the direction of the desired cursor movement. Or, 
you can use the arrow keys (pressing the CTRL key isn’t necessary) on the keyboard to 
move the cursor. The cursor shifts position at the same time that the cursor coordinates 
change to reflect the new location of the cursor. Don’t move the cursor off the edge of the 
screen just now. 

You can turn the cursor off, and incidentally remove the readout in the lower right. Press 
the SELECT key. Now the display is “clean.” This allows viewing without the distraction 
and clutter of the editing aids. 

Now, let's look at the whole map. Press and hold down the trigger button on the joystick, 
and pull the joystick toward you. This moves the screen “window” down the display. (You 
could also say that the display moves up. For scrolling, we always pay attention to the 
direction of window movement, not display movement.) To move the window under 
keyboard control, hold down the SHIFT key and press the down-arrow. Now, push the 
joystick to the right, or press the right-arrow to move the window to the right. You can 
move the window in any direction under joystick or keyboard control. This is called 
scrolling. The smooth movement of the window is called “fine” scrolling. The scrolling 
stops when the window arrives at the edge of the display. Examine the map. You’re 
looking at a map of a mythical kingdom. With Mapmaker you can make a map just like 
this. 
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Making a map 


Let’s find out how it’s done. Press the SELECT key again. Do you see the cursor? If it isn't 
on the screen already, it will be just outside the screen. Move the cursor until it appears 
on the edge of the screen. You may have noticed something else. The coordinate 
readout is now white. Press SELECT twice more; now it’s black again. This black/white 
shift allows you to read the coordinates whether the background color is light or dark. 

As you move the cursor around, notice how the cursor highlights the shape of individual 
map characters. This points out how a map is a set of redefined characters placed side 
by side. The concept is quite simple once you get used to it. Instead of letters on the 
screen, we have map characterr—trees, rivers and mountains. The shapes are con¬ 
tained on a diskette file called ALLPRPS.SET, which loaded into the computer during 
PROGRAM INITIALIZATION. 

Now, let's see how these characters are put on the screen. Position the character in an 
open space. The cursor is now just a blinking square. Press the START key. The cursor 
stops blinking. Next, press the semicolon ( ;) key. Voila! A tree. Press the START key 
again. The tree stops blinking. Now press the equal sign ( = ) key. Presto! Two 
mountains. Move the cursor away. The mountains remain, but they are blue. We want 
gold mountains, so position the cursor on the mountains and press the START key 
again. You see by now that this tells Mapmakeryou want to enter a new character at the 
cursor location. Before you press a key, press the ATARI logo key. Now press the key. 
The I (INVERSE video) indicator says ON. Move the cursor away, and IShazam! the 
mountains are gold. That’s all there is to it. Plug in characters at will. To remove those 
mountains, enter a blank character by pressing the space bar. To learn more about 
character sets and colors, read the sections titled “Character Sets” and “Color Regis¬ 
ters”. 


The Mapmaker menu 

Let’s look at some more Mapmaker features. Press the OPTION key to display the 
Mapmaker menu. We're back to the standard character set. The MENU contains six 
options. It also tells you how to use the MENU. You move the pointers by pressing 
SELECT. To choose an option, set the pointer on the option and press START. Note that 
SELECT and START have different functions, depending on whether you're in EDIT 
mode or MENU mode. If you were to press START now, you would return to the map. Go 
ahead and press it to verify what happens. Now, press OPTION again to return to the 
MENU. 

Press SELECT a few times, so the pointers are on CHANGE COLOR REGISTERS. 
Then press START. Now you're looking at the color palette routine. The color in the large 
screen area is the color of register 1. All the characters on the map that are this color are 
entered as register 1 characters. Press SELECT several times; as the text window 
indicates, this rotates the color registers. Next, we will change one of the colors. Select 
register B, the background color register. Right now, it’s a rust orange. Let's make it 
white, so the map will look like winter. To change colors, we need to change both hue and 
intensity. 
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Changing hue 


To change the hue, you use either the joystick or the arrow keys (you need to use CTRL 
with the arrow key in this instance). Push the joystick left or right, or press the left-arrow 
or right-arrow key. The color changes in the big window. Keep pushing the joystick or 
pressing the arrow key until the gray color appears. 


Changing intensity 

Now, change the intensity, which is the brightness of the color. We are currently looking 
at white, so a bright white is really white, while a dim white is gray, and a "dark" white is 
black. To change the intensity, push the joystick forward or back, or use the up-arrow or 
down-arrow. Get a nice bright white. Once you have it white, press OPTION to return to 
the MENU and then press START to return to the map. The background is now white, a 
field of snow. Or did you change the wrong register? Maybe you have snowy mountains 
instead. Go ahead; experiment with the colors. You’re getting used to using Mapmaker. 


Changing character sets 

After you’ve tried out the color changing routine, go back to the MENU and select the 
CHANGE FONT option. In Mapmakeryou work from a set of 64 characters. However, to 
make a complex display, we sometimes need more than 64 characters. The full charac¬ 
ter set has room for 128 characters. You can swap to the second set of 64 by using the 
CHANGE FONT option of the MENU. You still can’t use more than one of the 64 
character subsets on any one line of the display, but skilled programmers can divide the 
screen and use different sets at different map “latitudes.” With CHANGE FONT, you can 
swap the character base, or load an entirely new font of characters. This can make the 
map look pretty strange. 

Let's try it. Press START with the pointer on the CHANGE FONT option. Then, press the 
“S” key for “swap”. Now, return to EDIT mode. The map is no longer a map, but a field of 
text characters. Go back to the MENU again. Now, we want to exit from Mapmaker 
briefly. Set the pointer on the QUIT option. Make it a practice never to leave Mapmaker 
except through the QUIT option. This time, we don’t want to alter the demonstration file, 
and so we just QUIT. Now, press START and read the warning. This protects you from 
losing a lot of work by accident later on. This time, we press START again, and the 
program terminates after locking DEMO.MAP on the diskette. 
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Creating a new map 

Let's look at how to initiate a new map. Type RUN and press RETURN. The program 
returns you to PROGRAM INITIALIZATION. This time, type “C" in response to the 
Create...Load prompt. The program requests the dimensions of your new map, width 
first. Choose any even width between 22 and 128 (Mapmaker automatically rounds an 
odd number down by 1) and press RETURN. Using an even number is a requirement of 
the fine scrolling routine. Now choose the height; the range can be from 13 to 255. 
However, width times height cannot exceed either 4K (4096) on a 32K system, or 8K 
(8192) on a40K system. If you pick a height that is too large, /Mapmakerwill correct your 
number to an acceptable one. 

After entering height, Mapmaker starts creating your map display by laying out the 
workspace. It draws a border around your map area, and assigns a set of default colors 
to the color registers. (“Default” just means that these are the standard colors. Black is 
the ATARI default background color.) You can check these colors through the color 
palette routine. After drawing the border, you are ready to edit. Go to it. You’ve already 
done some editing. An appendix contains a complete listing of the all-purpose 
(ALLPRPS) character set. Read the sections titled “Character Sets" and “Color Regis¬ 
ters" to understand better how to use the characters. 


Saving a map 


To save your handiwork, go to the MENU and select the SAVE option. This will write your 
map to the diskette. Next time you run Mapmaker, you can recall your map for further 
editing, or for just showing off. It will be named FILE1 .MAP on the diskette. The section 
on the MENU options tells you more about saving maps. 

Be sure to read the rest of the manual before getting too far into using Mapmaker. It’s full 
of useful information. 
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Using Mapmaker 


Background 


Anyone who has experimented with the extensive graphics capabilities of the ATARI 
Computer is familiar with its high-resolution, multicolor graphics mode. Using this mode, 
a programmer can draw quite detailed pictures as long as he or she is willing to plot out 
the graphics commands needed to produce an elaborate display. Various hardware and 
software aids are available to help non-professional users create impressive hi-res 
screen displays. No matter what assistance is obtained from these products, however, 
hi-res displays are significant consumers of computer memory. A single screen of 
GRAPHICS 7 display requires about 4K of memory. While this is not too taxing for a 
BASIC program run on a 40K, disk-based system, few programmers are satisfied with a 
single hi-res picture. The alternatives for adding additional displays are either frequent 
disk access or significant additional memory commitment. 

A much more serious problem arises for programmers wanting to create and use a 
multiscreen display with viewing of the display through scrolling. At 3200 bytes per 
screen, a modest ten-screen display leaves no room for program logic. Obviously, this 
situation is unacceptable. Fortunately for ATARI Computer owners, the computer comes 
to the rescue with two advanced features that in combination make creating a hi-res, 
ten-screen display possible in just 2.4K of memory. These features are the five-color text 
modes and the ability of the ATARI Computer to use redefined character sets. 

Most users have seen displays using the larger multicolor text modes. In BASIC, these 
are the modes GRAPHICS 1 and 2. By using GRAPHICS 2, in particular, a single text 
character can fill an 8x8 pixel area of the screen. By redefining text characters so that 
they become portions of a picture or map display, a small allotment of screen memory 
can hold a truly impressive multiscreen display. Anyone who has seen the program 
Eastern Front (1941) can attest to the remarkable detail obtainable from a small amount 
of screen display memory. The multiscreen map, plus extensive game logic, of Eastern 
Front requires only 16K of memory. 

Mapmaker lets you make multiscreen displays using redefined GRAPHICS 2 charac¬ 
ters. Without Mapmaker, to create such a display, you’d have to arduously prepare a 
string of character names which, when displayed through an appropriate display list, 
would result in the desired map appearing on the screen. 

Mapmaker does not include a character set editor. There are a number of good text 
character editors on the market, including Instedit, available from APX. (See the section 
on “Character Sets” for a further discussion of character editors.) Mapmakens equipped 
with an all-purpose mapping character set so that users without a character editor can 
still use the program. This character set is further described in the section titled 
“Character Sets". The map file included with the program demonstrates what can be 
done with Mapmaker using the all-purpose character set. 

Mapmaker was originally developed to facilitate the creation of maps to be used in 
simulations of historical conflicts, in other words, for wargames. Wargame designers 
using Mapmaker w\W be encouraged to improve the quality of graphics in professionally 
designed simulation games. Whether you’re a professional simulation game designer, 
or are simply interested in getting the most personal enjoyment out of your ATARI 
Computer, you’ll find using Mapmaker a pleasurable and rewarding experience. 
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Program capabilities 

The standard dimensions of a GRAPHICS 2 full screen display (really GRAPHICS 2+16) 
is 20 characters wide by 12 lines high. The smallest display Mapmaker supports is a 
22x13 character display. This limitation is because the program uses a fine scrolling 
routine that cannot properly manage a single screen display. The limitation shouldn’t be 
considered a liability, however. You'll quickly discover that a small display area gives you 
insufficient range for an interesting display. 

By comparison to the minimum display size, the maximum display supported by Map- 
maker is truly awesome. The program makes up to 8K of memory available for screen 
display area. At 240 bytes per screen, 8K provides room for a single display comprising 
over 34 screens of total display area. Display width can vary from 22 to 128 characters; 
height can range from 13 to 255 character lines. The only limitations are that the product 
of width times height cannot exceed 8K (8192 bytes) and the width must be an even 
number (to simplify the fine scrolling routine). 

(If you have a 32K system, your maximum display area is limited to 4K of memory, rather 
than 8K. The full 8K is available only on systems with 40K or more of memory. However, 
a 4K area still leaves room for more than 17 screens of display.) 

GRAPHICS 2 is a five-color mode. That is, the characters can be any of four colors, and 
the background can be a fifth color. Mapmaker supplies a set of default colors (which 
differ from the standard ATARI default colors) and provides an easy-to-use facility for 
altering the “playfield” color registers to allow for any combination of five colors on the 
display. These color choices are stored with the diskette MAP file so that they are 
restored automatically upon recalling the map file. 

Your primary method of communicating with Mapmaker is through the keyboard. 
However, you can also use a joystick to control the display. The joystick provides for 
faster scrolling and cursor movement, particularly in diagonal motion. Other features 
include (1) the ability to swap character sets during editing, (2) a facility for accessing 
character editor programs directly from the Mapmaker program, (3) BREAK key disable¬ 
ment to protect against accidental loss of edit work, and (4) automatic file selection and 
naming. 

Creation of a multiscreen display is an unavoidably time-consuming task. Be prepared to 
spend several sessions creating a single display, and be prepared for a certain amount 
of tedious repetition entering characters for portions of displays, such as bodies of water. 
Clever choice of character shapes, as well as careful selection of field versus ground, will 
ease your task considerably. 

If you’re not very familiar with the concept of a hi-res display created from redefined 
character sets, read the section titled Understanding Redefined Text Displays" before 
using Mapmaker. 
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EDIT mode 


General information 

You use EDIT mode to edit your displays. While in EDIT mode, you can move the display 
window and the cursor using either the joystick or the arrow keys on the keyboard. You 
can alter the character under the cursor through the keyboard. The OPTION, SELECT 
and START keys all have important functions in EDIT mode. 


Scrolling 


Mapmaker's ability to create multiscreen displays is useless unless you can view 
different portions of the display with ease. This is accomplished with a fine scrolling 
routine, which moves the screen across the display like a window. The routine is 
described in detail in the section titled "Fine Scrolling’’. To scroll the display, hold down 
the SHIFT key and press any of the four arrow keys. The window moves in the direction 
of the arrow pressed. For example, to see portions of the display below the bottom of the 
screen, use the down arrow. 

You can also scroll the display using a joystick. Press and hold the red trigger button on 
the joystick while pushing the joystick in the direction of desired window movement. You 
can scroll diagonally with a joystick, whereas you can’t with the keyboard arrows. The 
display will not scroll past the borders which define the length and width of the display. 


The cursor 


When Mapmaker first goes into EDIT mode, the screen shows the upper left portion of 
the display. In the top left corner of the display, on the border, is a blinking cursor. The 
cursor keeps track of the current location of the character editor. In the lower right of the 
screen, the current coordinates of the cursor display. Starting from position 0,0 in the 
upper left, the X axis extends to the right along the width of the display. The Y axis runs 
down the screen matching the height of the display. As you move the cursor, the program 
constantly updates the coordinate information. The other information in the lower right 
concerns the status of the INVERSE flag. When this is OFF, character entry is in the 
colors of color registers 1 and 2. When the flag is ON, characters appear in the colors of 
registers 3 and 4. The flag flips each time you press the ATARI (INVERSE video) key 
prior to entering a new character onto the display. For more discussion of the INVERSE 
flag, see the section titled "Color Registers’’. 

You can move the cursor in several ways. You can move it by pressing an arrow key. 
Hold down an arrow key for repeated cursor movement. Or, you can move the cursor by 
pushing the joystick in the direction in which you want cursor movement. As with 
scrolling, you can move diagonally only through the joystick. The cursor also moves 
automatically under program control during scrolling. As the window is moved, the 
cursor remains in place. However, as the cursor disappears off the edge of the screen, it 
moves under program control so that it lurks about the edge of the display. This is 
indicated by the coordinates being updated during fine scrolling. When you finish 
scrolling, if the cursor isn't visible, a few cursor moves will bring it into view. Also, if you 
move the cursor off the screen, the cursor will move back to the screen as soon as you 
stop issuing cursor directions. 
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The cursor indicates the current location for character insertion onto the display. This is 
further discussed in the following section, "Character Editing." 

You can turn off the cursor to view the display without the distraction of a blinking cursor. 
Press the SELECT key to remove the cursor and the information display in the lower 
right of the screen. Press SELECT again to redisplay the cursor. The SELECT key also 
alters the “colors" of the coordinate data. Orginally displayed in black, the readout will 
display in white when the cursor is turned off and then turned on again. This is useful 
when you alter the background color from the default choice of white to a dark intensity 
color. Press SELECT twice more to redisplay the readout in black. 


Character editing 

You use the keyboard and the START key to enter and change characters on the display. 
Position the cursor at the location desired for a new character. Next, press the START 
key; the cursor stops blinking. Now press the key corresponding to the character 
desired. That character appears on the screen at the cursor location, and the cursor 
blinks again. The START key in EDIT mode signals to Mapmaker that the next key 
pressed should be translated into a character to be displayed at the current cursor 
location. You may press the ATARI key to change color registers after pressing the 
START key but before you press the key for the character. All keys are interpreted as 
characters, even RETURN, TAB, and SHIFT-CLEAR. The BREAK key is disabled. Any 
key you press is converted into characters. Therefore, you can't lose the display no 
matter what key you press (see the warning about the SYSTEM RESET key below, 
however). The keyboard is in lower case, so use the SHIFT key to enter uppercase 
characters. You can still use the CAPS-LOWR key to lock in upper case or the CON¬ 
TROL (CTRL) key when you need to enter a series of such characters. 

The SYSTEM RESET key has not been disabled or reprogrammed. Never press this 
button while using Mapmaker, unless you’re certain you don’t wish to save your map- 
work. To exit the program, use the MENU. 


Exiting EDIT mode 

Use the OPTION key to leave EDIT mode and return to the MENU, where you can 
access Mapmaker's special functions. You can also return to EDIT mode from the 
MENU. The next section describes the MENU functions. 


Mapmaker menu 


General information 

In addition to the ability to save and recall edited map files, Mapmaker contains several 
special functions, which you can access through the MENU. The options are described 
below. 


EDIT MAP 


Use this option to exit from the MENU and enter EDIT mode. The screen returns to the 
map display at the same location that was on the screen when you pressed the OPTION 
key. 


CHANGE FONT 

Use this option to load a different character set file. Or, you can swap the character base 
from the uppercase/punctuation set to the lowercase/control character set, and back. The 
alternatives are displayed when you press START while the pointers are set on this 
option. The choices are to press “S" to swap the character base, or “L" to load a new 
font. Be sure that the diskette containing the font to be loaded is already in the drive 
before choosing the “L" option. If there are several character sets on the diskette, the 
program gives you a choice of files to load. After loading or swapping a character set, you 
return to the MENU. 

RUN FONT EDITOR 

This selection isn’t active in this version of Mapmaker. Choosing this selection has no 
effect other than to reset the MENU pointer at EDIT MAP. It’s included because the 
option to move back and forth quickly and easily between Mapmaker and a character 
editor program is often desirable when you're designing the characters as they’re 
needed, rather than all at once before map editing commences. The option is inactive, in 
part, because its exact form depends on the character editor program in use, and in part 
because alterations are usually required in the editor program to optimize the rotation 
between it and Mapmaker. See the section titled “Character Sets" for further informa¬ 
tion. 

CHANGE COLOR REGISTERS 

Use this option to activate a mechanism for altering the colors in the five “playfieid" color 
registers. The screen shows a split-screen display. The color of register 1 fills the upper 
area. In the lower text window are instructions for altering the registers. 
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You can vary both the hue and the intensity of colors, using either the keyboard or 
joystick. To change the hue, move the joystick right or left, or hold down the CTRL key 
and press the left-arrow or right-arrow. As the text window indicates, the first register 
displayed is register 1. To select registers 2 - 4 or the background “B” register, press the 
SELECT key. The color of each register displays in turn. The colors selected apply only 
to the map display, but the changes are permanent, and are stored with the map file on 
diskette. You can alter them again by returning to this option. Press the OPTION key to 
return to the MENU. Instructions for using the color changing facility display in the text 
window. 


SAME MAP TO DISK 

Use this option to save your entire map on the diskette currently in drive 1. Use SAVE 
often; it protects your work. The file will contain the values of the five color registers for 
the map at the time you select this option. Mapmaker includes an automatic file naming 
facility. If you’re creating a new map display, Mapmaker assigns the name FILE1 .MAP to 
your map the first time you save it. If a file already exists on the diskette named 
FILE1 .MAP, Mapmaker overwrites it, unless it is currently locked. If Mapmaker encoun¬ 
ters such a locked file, the program names the new map file FILE2.MAP. Subsequent 
files are named FILE3.MAP, and so on. 

At PROGRAM INITIALIZATION time, if you’re loading an existing MAP file, that file is 
unlocked, and Mapmakeruses that filename when you select the SAVE option. You may 
freely change filenames through the DOS menu. The only requirement is that the 
extender of the filename must be “.MAP” (for example, “USA.MAP”). The automatic 
filenaming facility is efficient and safe, but it requires you always to exit Mapmaker by 
way of the QUIT option. Never leave Mapmaker by pressing the SYSTEM RESET 
key. Once the MAP file has been saved, control returns to the MENU. You can return to 
EDIT mode or terminate the session using the QUIT option. See the section on MAP 
FILES for further information regarding the contents of saved files. 


QUIT 


Use this option to leave Mapmaker. Using QUIT right after using the SAVE option locks 
your MAP file before you exit the program. Otherwise, when you select QUIT, the 
program displays a warning that no SAVE has occurred since the last time you were in 
EDIT mode. If you forgot to save your display, press OPTION to return to the MENU. 
Otherwise, pressing START again locks any currently open MAP file and returns you to 
BASIC. 
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Technical information 


Understanding redefined text displays 

To understand the technique involved in creating a text-based, high-resolution display, 
you first need to understand the difference between a text mode and a bit-map mode. 
The computer generated display on the television screen is composed of many small 
dots, called “pixels" (for “picture element”). A given pixel appears as a dot of color on the 
screen, or as a gray or white dot. Screen displays are made up of patterns of these dots. 
A bit-map display uses computer memory to store the status of individual pixels using 
one or two bits of memory. Two-color, bit-map graphics modes use one bit per pixel (“on" 
or “off”), whereas four-color modes use two bits per pixel (to choose one of four colors). 
Although these modes let a single byte of memory store the color data for four or eight 
individual pixels, higher resolution displays can have thousands of pixels on the screen. 

Text modes, on the other hand, use relatively little screen memory, because each byte 
now names a text character. Individual text characters on the screen comprise an area of 
64 pixels (an 8x8 area); hence much less memory is needed to fill the screen. When 
operating in a text mode, the screen display system reads each byte of screen memory 
and uses the value found to locate an eight-byte shape in a table of character shapes. 
The 64 bits of this byte group describe the appearance of the text character on the 
screen. For example, Figure 1 shows the shape of the letter “R” in standard ATARI text 
format. 



Figure 1 


R" in standard ATARI text format 


The standard text character shape table is stored in a 1K area of the 10K ROM Operating 
System. One byte in RAM, address 756 ($2F4 hex), and referred to as CHBAS, is a 
“pointer" to the table of text shapes. This means that location 756 contains the high byte 
of the two-byte address where the shape table begins. The shape table starts at location 
57344 ($E000) and so the value stored in location 756 is 224 ($E0), which is 57344 
divided by 256. If you were to change the address stored in CHBAS, you would be telling 
the computer to look elsewhere to find the shape table. This lets you create a table of 
alternate character shapes, store that table in a 1K area of RAM, and tell the ATARI to 
use that set of shapes for displaying text on the screen. 

Suppose you’ve redefined the shape of the letter “R" to look like the shape in Figure 2. 
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Figure 2 


Redefined " R 


Now when you call for the letter “FT on the screen, you see in its place a tree. To create a 
forest on the screen, you would enter several R's in close contact. As characters are put 
on the screen, they stand shoulder to shoulder without visible gaps or seams. Standard 
characters maintain separation by not filling the entire 8x8 area they are allocated. In 
redefining text shapes, you can run right up to the borders of the character grid. Rivers 
and coastline are generated by making characters which meet at common locations on 
the edges of the character grid. Figure 3 shows two shapes of “North Coast” characters 
which, when placed side by side, display an irregular pattern of seacoast. 


rib 

Figure 3 North Coast Characters 



To accomplish the Mapmaker technique, you create a variant character set with sym¬ 
bolic and cartographic shapes, then load that shape table into RAM, point to it, and start 
plugging in characters in a multiscreen GRAPHICS 2 + 16 (i.e., full-screen) display. 
Mapmaker provides an all-purpose mapping character set (the file is named 
ALLPRPS.SET) for you to experiment with. However, the full power of Mapmaker comes 
into play when you use a character editor program to create your own redefined 
character set. 

Mapmaker uses GRAPHICS 2 for two reasons. First, GRAPHICS 1 and 2 are five-color 
modes, compared to GRAPHICS 0, which is only a 1 1 /2-color mode. Second, Mapmaker 
uses GRAPHICS 2 rather than 1 because GRAPHICS 2 characters appear square on 
the screen whereas GRAPHICS 1 characters appear rectangular. The GRAPHICS 2 
characters fill a larger area of screen per character, and thus use the least amount of 
memory per screen display. 

In GRAPHICS 2, only 64 of the 128 character shapes are available for use because two 
bits of the byte that stores the character "name” value are used to denote the color the 
character should be displayed in. The remaining six bits provide for a range of values 
from 0 to 63. Thus, a given map in Mapmaker is limited to 64 different shapes. Usually, 
this is more than enough. 

For more information about redefined character sets, see the BIBLIOGRAPHY. A 
thorough understanding of this facet of the ATARI Computer's design is critical to optimal 
use of Mapmaker. 
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Character sets 


The magic ingredient in Mapmaker displays is the redefined character set. The section 
titled “Understanding Redefined Text Displays" briefly explains the technique. You can 
obtain more information from some of the literature mentioned in the BIBLIOGRAPHY. 
This section addresses facets of redefined character sets of particular importance in 
using Mapmaker. 

You can't create new character sets with Mapmaker. For that you need a character set 
editor. Instedit, the character set editor available through APX, creates files with a 
filename extender of “SET” that Mapmaker accepts as character sets. Another good 
editor is Fontedit, which is part of IRIDIS #2, published by The Code Works. Mapmaker 
accepts files created by Fontedit. These use “FNT” as a filename extender. You may 
prefer yet another character editor. To be usable by Mapmaker, a character set file must 
have the following characteristics: 

1. The filename must have the extender “SET” or “FNT”. 

2. The file must be a 1K binary format file of character shapes in the same order as 
they appear in the ROM OS. 

When using a character set in large text graphics modes, only 64 characters of the 128 
character set are available since the one-byte character “name" must include the color 
register value for displaying that character. Two bits identify the color; the other six bits 
name the character. Mapmaker initializes with the uppercase/punctuation subset of the 
character set. When redefining a set, use this subset rather than the lowercase/control 
character subset. You may use the latter, provided you also use the CHANGE FONT 
option in the MENU to swap the character base. 

A blank font table is provided in the back of this manual to help you in creating new fonts. 
As you create characters, enter their descriptions into the appropriate areas of the table. 
You may make photocopies of this table for your personal use only. 

The table also indicates the keys corresponding to the uppercase/punctuation set for 
generating characters in registers 2 and 4. For example, “A” generates a character in 
color 1, while “a” displays the same character in color 2. Of course, the same correspon¬ 
dence applies for registers 3 and 4. The difference is that the INVERSE flag must be ON 
to obtain registers 3 and 4. The status of the INVERSE flag is provided along with the 
cursor coordinate readout. 

When creating a new character set, a few guidelines should be followed. Virtually every 
character set needs a “fill” character and a “null" character. Mapmaker expects the first 
character in the set to be the “null” character, obtained by pressing the space bar. This is 
ASCII value 32 ($20) and internal value 0. This is the same as the standard character 
set. If you use the lowercase subset, you must redefine the CONTROL-COMMA 
character to be blank. Mapmaker also expects to find a “fill” character at ASCII 42 ($2A). 
This is value 10 ($0A) in internal code and it corresponds to the asterisk ( * ) character. 
The standard character set lacks a "fill" character, that is, a character with all 64 pixels 
“on”. This corresponds to the inverse of a blank. The “*” was chosen because it’s close 
to both the START key and the arrow keys. You’ll find many occasions to enter multiple 
fill characters. Since the map border consists of register 4 fill characters, the automatic 
border drawing routine creates a useless edging if the “*” character isn’t properly 
defined to be “fill.” The other 62 characters can be any shapes you desire. 
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A disciplined approach to creating a new map begins with a plan for the colors and 
shapes you’ll need to interpret the image you wish to display. Keep in mind that 64 
shapes are not really all that many. Avoid too many unique shapes and get as much use 
out of all 64 as possible. If you’re using Instedit, you’ll see the standard character set 
displayed in a table. Your first step will be to change the character to a fill character, 
all pixels on. Then start constructing your other shapes by selecting each character in 
turn, reconfiguring it to suit your needs. Remember that you must use either the 
uppercase/punctuation half of the set or the lowercase/control character portion. With 
Instedit you can try out different character combinations as you create them. You can 
always go back and revise individual characters if they don't look quite right in your map, 
but you'll save some time by trying them out as you create them. 

After each character is edited, enter a description of the new character in the Character 
Set Table next to its corresponding key character. You can make photocopies of the 
table in the back of this manual to help you keep track of your character sets. 

The SAVE command in INSTEDIT is the proper method for storing your character set on 
diskette for Mapmaker’s benefit. You can put several .SET files on a single diskette; 
Mapmaker will give you a choice of files to load if it encounters more than one. 

The file ALLPRPS.SET is designed to be an all-purpose mapping font. It contains many 
standard mapping characters, and provides good examples of how irregular terrain can 
be created through artful character design. Note, for example, that all river characters 
terminate at the same point on corresponding sides of each character. Coastline can be 
varied by one pixel for its endpoints as this fits with the irregularity of the coast in any 
event. At least two characters of each type of terrain should be made to provide for 
variety and to enhance irregularity. For extended coastlines, four different characters 
provide a more authentic look. 

In sum, a map is only as good as its character set. The more creative your character set, 
the more original and appealing will be your map. Mapmaker encourages experimenta¬ 
tion because it’s so easy to use. 

Option 3: RUN FONT EDITOR 

In the description of the MENU, the third option, RUN FONT EDITOR, is inactive. 
Inquisitive users will discover that lines 7190 and 7195 of MAPMAKER.BAS contain 
REM lines with code for activating this MENU item. You can implement them by 
removing the REM's and inserting the name of your character editor program in line 
7195. If it were this easy, however, the choice would have been made active. In reality, 
the task is more difficult. Some modification will probably be necessary to your character 
set editor program before this transition works smoothly. The goal is to have the editor 
program come up with the current redefined font already accessible for further editing. 
The editor program should also provide a quick return to Mapmaker. The solution isn’t in 
this manual. You’ll need to devise the proper code for linking the two programs. 
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Careful selection of color mixtures is critical to an attractive display. Mapmaker uses 
BASIC’s GRAPHICS 2 mode to display characters. This is a five-color text mode, 
meaning that each character can be displayed in one of four colors against a background 
that can be a fifth color. A single character can’t contain more than one color. There are 
other graphics modes in the ATARI Computer that do allow for multicolor text characters. 
Mapmaker doesn’t currently support these other modes, however. This means that any 
one square of map area should not contain more than one map feature. If you want a 
river to wind through a forest, put tree characters next to the river charcters. The only way 
to put tree and river in the same character is to have them both the same color. If you like 
green rivers or blue trees, go ahead. Another problem with mixing features in a single 
character is that the character becomes too specialized. With only 64 characters in your 
palette, you have to get a lot of use out of almost all of them. Creating too many unique 
characters limits your display. 

Recall that the character "name” selects both character and color. This feature deserves 
more explanation. Each character on the screen corresponds to one byte in RAM. The 
position of those bytes determines the position of the characters in the display. In reality, 
the display is one-dimensional in RAM. If the display is, for example, 80 characters wide, 
then the first 80 bytes of display RAM hold the top row of the display, the next 80 bytes 
hold the next row, and so on. In each byte is a value corresponding to the character to be 
displayed. Suppose a particular byte is to display the “fill” character in the color of 
register 4. This is, in fact, what the display border is composed of. The byte will then hold 
this binary value: 11001010. The two high bits, 11, designate the color. This is read as a 
binary value of 3 in decimal. A two-bit value can range from 0 to 3. For ease and clarity, 
we number the color registers 1 to 4, but internally they are numbered 0 to 3. Hence, 11 
binary refers to color register 4, i.e., the fourth of four. The other six bits ”001010” are 
read as value 10 decimal, the internal code value for the character, which we 
redefined as the “fill” character. Since six bits can range from 0 to 63, we can name 64 
characters in this graphics mode. So we see that the binary value “11001010” or 202 
decimal ($CA) “names” the “fill” character in color 4. 

Color mixing is a process of trial and error. The ATARI Computer has a lot of colors to 
choose from, in part so that you can obtain pleasing color combinations. Intensity of the 
different color registers plays a key role in color mixing. Too many dark colors make a 
dim, muddy display that doesn’t show good contrast. Too many bright colors can be 
unpleasantly dazzling. The default colors were chosen to provide some basic shades 
that work acceptably well together. Your displays don’t have to keep to these color 
choices. 

One guideline for selecting colors that makes mapping easier and lets /Mapmaker work 
better for you is as follows. Registers 1 and 3 should be of contrasting intensity, and the 
same for registers 2 and 4. You’ll want to maintain some contrast anyway, and this 
scheme works better in Mapmaker because the cursor blinks by shifting colors between 
registers 1-3 and 2-4. If these colors are too similar, the cursor won’t have enough 
contrast to provide a noticeable blink. If you have changed colors and find the cursor 
hard to spot, readjust the colors for more contrast. You can always change the colors 
again when you’ve completed the map. 
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One final note that applies to both characters and colors: as you create a map with 
Mapmaker, you are constructing a “field/ground" display. By this is meant that you're 
designating a background color and then overlaying shapes on the background in other 
colors. It's more usual to see the shapes as “field”, that is, covering the background with 
their shape content. It’s entirely possible, however, to create shapes from the “ground ”, 
that is, to outline the shapes, fill all the character area around the shape, and let the 
background color show through as the representation of the shape. While the more 
customary approach is recommended, certain maps may call for a field/ground reversal 
that could result in a stunning display. The point is not to let your imagination be bounded 
by what you’ve seen. There are many paths to orginality. 


Map files 


If you ever plan to do anything with the maps you create other than to revel in how clever 
they are, you must understand the structure of the files in which they are saved on 
diskette. The map data files must have the extender “MAP” in the filename. Mapmaker 
recognizes no other data file. The program also contains an automatic file naming 
system described earlier in this manual. 

When Mapmaker saves a display, it writes a diskette file, which contains three subele¬ 
ments. The first two bytes of the file are the width and height of the display in numbers of 
characters. These values are always less than 256 and thus are one byte in size. When a 
file is read in, these two values are used to determine the amount of display RAM 
required for the display. This is particularly critical considering that a display block cannot 
cross a 4K boundary in RAM, while Mapmaker displays can range up to 8K. 

The next five bytes on the file are the values of the five color registers, first the four text 
registers and then the background color. This enables Mapmaker to restore the color 
choices made during earlier editing sessions. The third and largest subsection of the file 
is the map data. This is written by the simple yet effective method of defining the entire 
display area in RAM as the buffer for a CIO call for disk output. I am indebted to the 
publication De Re ATARI for describing the function and use of the IOCB in relation to 
the multiple GET CHARACTERS function. This little subroutine string (CIOS) in Map- 
maker does yeoman service in quickly reading in font and map files and in writing out 
display data. Five simple POKES and a USR call, and you can read or write any data file. 
Lines 8000-8080 in Mapmaker write the MAP file. If you can understand this, you can 
construct the necessary code to read the map into another program application. Making 
maps is fun, but using them in other programs is rewarding. Read De Re ATARI and 
examine Mapmaker, then write your own program around a map display of your own 
creation. That is what Mapmaker was really created for. 
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Face it, you really have to know something about assembly language to implement fine 
scrolling. This technique requires not only a wholesale modification (actually a complete 
rewrite) of the display list, but also the ability to update the entire display list during the 
course of a single vertical blank. Furthermore, my experiments with the fine scrolling 
registers suggest that trying to manipulate them with POKEs simply results in a jumpy, 
unstable screen display. In short, if you don’t know a lot about display lists, USR routines 
and vertical blank interrupts, get someone to teach you before you try to implement fine 
scrolling. 

Assuming you are at ease with these subjects, the assembly listing of SCROLL.OBJ is 
provided for your information. It is read into the unused area of the player-missile 
graphics region, which physically resides just below the display area in Mapmaker. (You 
didn’t realize Mapmaker has PM graphics? What do you think the cursor coordinate 
readout is?) Once read in, it is activated by a short USR routine in line 11601 that resets 
the immediate vertical blank vector to the address of SCROLL. Henceforth, each time 
the screen is drawn, this routine is executed. It looks to see if the proper keyboard or 
joystick conditions exist to command scrolling, and if these are tripped, it executes the 
proper steps to accomplish the scrolling function. 

The assembly listing is pretty well documented. If you intend to use a map of your 
creation in another program, you’ll have to use a routine similar to SCROLL to enable 
you to see the whole display. Note that SCROLL uses some page zero of RAM and also 
stores some values in page six. SCROLL used to live in page six. That was when it was 
only joystick-driven. When I added keyboard drive, it outgrew one page of RAM. I moved 
it, but the data addresses stuck. There is so much going on in Mapmaker anyway, what 
with vertical blank interrupts and multiple display lists, that I thought it best to ban any 
other routines from page six while Mapmaker was running. Note, by the way, that 
Mapmaker supports three separate display lists simultaneously. 

De Re ATARI has something to say about fine scrolling, but you have to see it in action to 
really learn how to use it. SCROLL is in this manual because you have to understand the 
technique before you can apply your maps to other applications. I hope it becomes a little 
clearer to those of you who choose to delve more deeply into your computer’s capabili¬ 
ties. 
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SCROLL is an integral part of a program called 
MAPMAKER. It provides the capability to fine 
scroll a multi-screen display. 

SCROLL operates under either Keyboard or 
Joystick control. It takes the joystick value 
(or the Keyboard arrow key value concerted to 
its equivalent joystick value) arid interprets 
that value into display movement actions. Fine 
scrolling is a combination of incrementing the 
fine scroll registers and adjusting the LMS 
(Load Memory Scan) addresses in the display 
list to accomplish a coarse scroll each time 
the fine scroll register wraps around its 
maximum value. 

The lines preceding label EXIT establish that the 
conditions for scrolling are met. They take the 
joystick value (or the converted key value) into 
the actual scrolling routines which follow. 

Four essentially similar sections accomplish the 
scrolling. Each section directs scrolling in a pri¬ 
mary direction. 

SCROLL is a vertical blank interrupt routine. It 
executes every vertical blank. Once loaded into RAM. 
it is enabled by a USR routine in MAPMAKER. 

To accomplish fast scrolling with the keyboard i SCROLL 
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.RETRIEVE ORIGINAL VALUE 


24 Appendices 




SCROLL.SRC ASSEMBLED AS SCROLL.OBJ 



r * 


6018 


1010 

. PAGE 

GO IB 

2940 

1020 

AND#$40 

SO 1D 

F022 

1030 

BEQ 

EXIT 

GO 1 F 

8A 

1040 

TXA 


6020 

290F 

1050 

AND 

#$0F 

6022 

AA 

1060 

TAX 


6023 

2906 

1070 

AND 

*6 

6025 

C906 

1080 

CMP 

#6 

6027 

DO 18 

1090 

BNE 

EXIT 

6029 

A9FF 

1 100 

LDA 

#$FF 

G02B 

8DFC02 

1110 

STA 

CH 

602E 

8A 

1 1 20 

TXA 


602F 

C90F 

1 130 

CMP 

#15 

6031 

D005 

1140 

BNE 

BYE 

6033 

A90D 

1150 

LDA 

#13 

6035 

AA 

1 160 

TAX 


6036 

DOOC 

1170 

BNE 

SCRLK 

6038 

C906 

1180 BYE 

CMP 

#6 

603A 

D008 

1190 

BNE 

SCRLK 

603C 

A90B 

1200 

LDA 

#11 

603E 

AA 

1210 

TAX 


G03F 

DO 03 

1220 

BNE 

SCRLK 

6041 

60F506 

1230 EXIT 

JMP 

(VBLIN) 

6044 

0980 

1240 SCRLK 

ORA 

#$80 

6046 

AA 

1250 

TAX 


6047 

D8 

1260 SCRL 

CLD 


6048 

2908 

1270 

AND 

#8 

604 A 

0031 

1280 

BNE 

NEXT2 

G04C 

A5CD 

1290 

LDA 

HSDAT 

604E 

290F 

1300 

AND 

#$0F 

6050 

D023 

1310 

BNE 

PASS 1 

6052 

ADF706 

1320 

LDA 

LINEOUT 

6055 

CDFOOS 

1330 

CMP 

HLEN 

6058 

F 023 

1340 

BEQ 

NEXT2 

605 A 

A004 

1350 

LDY 

#4 

G05C 

B1C3 

1360 LOOP 1 

LDA 

( INDA) ,’ 

605E 

18 

1370 

CLC 


605F 

6902 

1380 

ADC 

#2 

6061 

91CB 

1390 

STA 

( INDA) , 

6063 

C8 

1400 

I NY 


6064 

B1CB 

1410 

LDA 

( INDA ) , 

6068 

6900 

1420 

ADC 

#0 

6068 

9 1CB 

1430 

STA 

<INDA) , 

606A 

C8 

1440 

INY 


G06B 

C8 

1450 

I NY 


606C 

C02B 

1460 

CPY 

#43 

60GE 

DOEC 

1470 

BNE 

L00P1 

6070 

EEF706 

14 80 

INC 

LINEOUT 

6073 

A5CD 

1490 

LDA 

HSDAT 

6075 

18 

1500 PASS 1 

CLC 


6076 

69FF 

1510 

ADC 

#$FF 


iTEST FOR SHIFT BIT 

ilF OFF. NOT A SCROLL VALUE 

.RETRIEVE 

iSTRIP OFF BITS 4-7 
iSTORE IN X 

;the four arrow keys all have 

; BITS 1 AND 2 ON. THIS TESTS 
i FOR THESE FOUR KEYS 
.CLEAR THE KEYBOARD REGISTER 
i BY POKING A 255 INTO IT 
iRETRIEVE 

iKEY VALUE 15 EQUATES TO STICK 
; VALUE 13. IF EQUAL TO 15, THEN 
i CONVERT TO 13 AND GO TO SCROLL 


'.IT WASN'T 15. IS IT S’ IF NOT, THE KEY 
i VALUE IS THE SAME AS THE STICK VALUE 
.CONVERT S TO 11 STICK VALUE 
iSTORE IT 
iSKIP A LINE 

iEXIT POINT FOR NO SCROLL 
iON AN ARROW SCROLL, SET BIT 7 
ISTORE IT 

i SCROLL DISPLAY LEFT STARTS HERE 
iTEST FOR BIT 3 
iON? GO TO NEXT DIRECTION 
.GET CURRENT HORIZ. FINE SCROLL VALUE 
iTEST BITS 0-3 
iANY ON? FINE SCROLL ONLY 
i GET THE HORIZ. COARSE COUNTER 
iCOMPARE TO HORIZ. COARSE LIMIT 
iREACH LIMIT? THEN DON'T SCROLL 
iBEGIN COARSE 1 SCROLL ROUTINE 

i THIS SECTION GETS THE LOW BYTE 
i OF EACH LOAD MEMORY SCAN ADDRESS 
i IN THE DISPLAY LIST AND 
i ADS 2 TO IT, THEN STORES IT BACK 
i IN PLACE. THEN IT GETS THE HIGH 
i BYTE AND ADDS THE OVERFLOW, 
i IF ANY. WHY 2’ BECAUSE FINE 
i HORIZ. SCROLLING RANGES OVER 2 
i CHARACTERS IN LARGE TEXT MODE. 

iEND OF COARSE SCROLL LOOP 
iADD 1 TO THE HORIZ. COUNT 
iGET THE HSCROL VALUE 

iSUBTRACT 1 


r* 
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SCROLL.SRC ASSEMBLED AS SCROLL.OBJ 


6078 


1520 


. PAGE 

6078 

85CD 

1530 


STA 

HSDAT 

S07A 

8D04DR 

1540 


STA 

HSCROL 

607D 

8A 

1550 

NEXT2 

TX A 


S07E 

2904 

1560 


AND 

*4 

6080 

D030 

1570 


BNE 

NEXT3 

6082 

A5CD 

1580 


LD A 

HSDAT 

6084 

290F 

1590 


AND 

#*0F 

6086 

C90F 

1600 


CMP 

#15 

6088 

D020 

1610 


BNE 

PASS2 

608A 

ADF706 

1620 


LDA 

LINEOUT 

608D 

F023 

1630 


BED 

NEXT3 

G08F 

A004 

1640 


LDY 

#4 

8081 

B1CB 

1650 

L00P2 

LDA 

< INDA) 

8093 

18 

1660 


CLC 


6094 

69FE 

1670 


ADC 

#*FE 

6096 

91CB 

1680 


STA 

( INDA) 

6098 

C8 

1690 


I NY 


6099 

B1 CB 

1700 


LDA 

( INDA) 

609B 

E900 

1710 


SBC 

#0 

6090 

9 1 CB 

1720 


STA 

(INDA), 

609F 

C8 

1730 


I NY 


SOAO 

C8 

1740 


I NY 


60A1 

C02B 

1750 


CPY 

#43 

60A3 

DOEC 

1760 


BNE 

L00P2 

60A5 

CEF70G 

1770 


DEC 

LINEOUT 

60A8 

A5CD 

1780 


LDA 

HSDAT 

60 AA 

18 

1790 

PASS2 

CLC 


60 AB 

G901 

1800 


ADC 

#1 

60 AD 

85CD 

1810 


STA 

HSDAT 

GOAF 

8D04D4 

1820 


STA 

HSCROL 

S0B2 

8 A 

1830 

NEXT3 

TXA 


60B3 

2902 

1840 


AND 

#2 

GOBS 

D 0 3 4 

1850 


BNE 

NEXT4 

60B7 

A5CE 

1880 


LDA 

USD AT 

60B9 

290F 

1870 


AND 

#*0F 

60BB 

C90F 

1880 


CMP 

#15 

60BD 

D024 

1890 


BNE 

PASS3 

60BF 

A0F80G 

1900 


LDA 

PAGEOUT 

60C2 

CDF 106 

1910 


CMP 

VLEN 

60C5 

F024 

1920 


BEQ 

NEXT 4 

G0C7 

A004 

1930 


LDY 

#4 

G0C9 

B 1 CB 

1940 

L00P3 

LDA 

(INDA) , 

60CB 

18 

1950 


CLC 


60CC 

GDF20G 

1960 


ADC 

INCRA 

GOCF 

91 CB 

1970 


STA 

(INDA) , 

GOD 1 

C8 

1980 


I NY 


60D2 

B 1 CB 

1990 


LDA 

(INDA) , 

60D4 

6900 

2000 


ADC 

#0 

6006 

9 1 CB 

2010 


STA 

(INDA) , 

GODS 

C8 

2020 


I NY 



STORE IT IN THE SHADOW. AND IN 
THE H0RI2. FINE SCROLL REG. 

NOW REPEAT THE PROCESS FOR BIT 2 

THIS SECTION MOVES THE DISPLAY RIGHT 


iMOVE THE DISPLAY 


UP HERE 


FOR UP-DOWN COARSE SCROLLING, 
ADD OR SUBTRACT THE SIZE 
OF THE DISPLAY WIDTH. 


26 Appendices 






SCROLL.SRC ASSEMBLED AS SCROLL.OBJ 


SODS 


2030 

. PAGE 

GODS 

C8 

2040 

I NY 


SODA 

C02B 

2050 

CPY 

*43 

SODC 

DOEB 

2060 

BNE 

L00P3 

GODE 

EEF806 

2070 

INC 

PAGEOUT 

SOE1 

A5CE 

2080 

LD A 

OSD AT 

GOE3 

18 

2090 PASS3 

CLC 


G0E4 

6301 

2100 

ADC 

#1 

GOES 

85CE 

2110 

STA 

OSD AT 

GOES 

8D05D4 

2120 

STA 

OSCROL 

GOEB 

8A 

2130 NEXT4 

TXA 


60EC 

2301 

2140 

AND 

#1 

GOEE 

D02F 

2150 

BNE 

EXIT2 

60 FO 

A5CE 

21 GO 

LDA 

OSD AT 

60F2 

2S0F 

2170 

AND 

*$0F 

GOF A 

D021 

2180 

BNE 

PASS4 

GOFG 

ADF80G 

2190 

LDA 

PAGEOUT 

GOFS 

F024 

2200 

BEQ 

EXIT2 

GOFB 

A004 

2210 

LDY 

#4 

GOFD 

B1CB 

2220 L00P4 

LDA 

(INDA) , 

GOFF 

18 

2230 

CLC 


6100 

SDF30G 

2240 

ADC 

DECRA 

6103 

9 1CB 

2250 

STA 

(INDA) , 

G 1 05 

C8 

22G0 

I NY 


610G 

B 1 CB 

2270 

LDA 

(INDA) , 

G 108 

ESOO 

2280 

SBC 

#0 

G10A 

S 1 CB 

2290 

STA 

(INDA) , 

6 IOC 

C8 

2300 

I NY 


610D 

CB 

2310 

I NY 


G10E 

C02B 

2320 

CPY 

#43 

G110 

DOEB 

2330 

BNE 

L00P4 

G1 12 

CEF80G 

2340 

DEC 

PAGEOUT 

G115 

A5CE 

2350 

LDA 

OSDAT 

6117 

18 

23G0 PASS4 

CLC 


6118 

GSFF 

2370 

ADC 

#$FF 

61 1A 

85CE 

2380 

STA 

OSDAT 

G1 1C 

8D05D4 

2390 

STA 

OSCROL 

G1 IF 

8A 

2400 EXIT2 

TXA 


6120 

1005 

2410 

B PL 

EXIT3 

6122 

ASO1 

2420 

LDA 

#*01 

G1 2 A 

802B02 

2430 

STA 

SRTIMR 

6127 

FB 

2440 EXIT3 

SED 


G128 

GCF50G 

2450 

JMP 

(OBLIN) 

G12B 


24G0 

. END 


iMOVE THE DISPLAY DOWN HERE 


iGET THE VALUE ONE MORE TIME 

ilF A STICK SCROLL, GET OUT 

SON A KEYBOARD SCROLL, WE WANT TO 

i DISABLE DEBOUNCE. THIS DOES IT. 

iRESET THE DECIMAL FLAG FOR BASIC 


Appendices 27 



FILENAME: ALLPRPS.SET (.SET)(.FNT) 


REG 1 

REG 2 

REG 3 

REG a 


REG 1 

REG 2 

SPACE 

C( . ) 



__CITY—i 

@ 

C< . ) 

! 

C< A) 



-N COAST- 

A 

a 

" 

C ( B ) 



-N COAST- 

B 

b 

# 

C(C) 



-N COAST- 

C 

c 

$ 

C ( D ) 



NE COAST- 

D 

d 

1 

C ( E ) 



NE COAST- 

E 

e 


C ( F ) 



-E COAST- 

F 

f 

' 

C(G) 



-E COAST- 

G 


( 

C ( H ) 



-E COAST- 

H 

h 

) 

C( I ) 



SE COAST- 

i 

i 

* 

C< J) 



SE COAST- 

j 

J 

+ 

C ( K ) 



_S COAST- 

K 

K 

» 

C(L) 



-S COAST- 

L 

i 

- 

C(M> 



-S COAST- 

M 

m 

. 

C ( N ) 



SW COAST. 

N 

n 

/ 

C(0> 



SW COAST- 

O 

0 

0 

C(P) 



-W COAST- 

p 

p 

1 

C(O) 



-W COAST- 

0 

q 

2 

C ( R ) 



_W COAST- 

R 

r 

3 

C(S) 



NW COAST- 

S 

5 

a 

C ( T ) 



NW COAST- 

T 

t 

5 

C(U) 



-LT SHIP- 

u 

U 

G 

C ( V ) 



-RT SHIP- 

V 

u 

7 

C(W) 



-LT TANK- 

w 

w 

8 

COO 



_RT TANK- 

X 

X 

9 

C ( Y ) 



-CAVALRY- 

Y 

y 


C(Z) 



-SOLDIER- 

2 

z 

5 

ESC 


RETURN 

LG GRASS- 

i 

C( i ) 

< 

C( - > 


SH DEL 

LOHI GRAS 

\ 

J 

= 

C( = ) 


SH INS 

HILO GRAS 

] 

SH < < ) 

y 

C( + > 


C < TAB ) 

--LAKE_ 

A 

BACK S 


C < * ) 


SH TAB 

--GEAR_ 

_ 

TAB 


REG 3 


__BLANK__ 
WNS RIVER 
NS RIVER- 
NW RIVER- 
WNE RIVER 
SW RIVER. 
NSE RIVER 
EW RIVER- 
USE RIVER 
WNE RIVER 

— F I LI_ 

-R MOUTH- 
LG RIVER- 
L-S RIVER 
-FACTORY- 
__TOWER__ 
LT CASTLE 
RT CASTLE 

_FLAG_ 

SWASTIKA- 
MLT CROSS 

--STAR_ 

LT BSHIP- 
CT BSHIP- 
RT BSHIP- 
HILO TREE 
LOHI TREE 
-LG TREE- 
HILO MNT_ 
LOHI MNT_ 
LG MOUNT- 
-VOLCANO- 


NOTE: "C" means CONTROL (CTRL) KEY and (character)* 
",S H 11 means SHIFT KEY and (character). 

"DEL" means DELETE KEY. 

"INS" means INSERT KEY. 

"REG" means COLOR REGISTER. 

LT = 1e f t CT=center RT=risht LG=larse M T = m o u n t a i n 
"River mouth" is a West Coast character 
"L-S River" means larse-to-small conversion 
" +" , " ," and " -" are meant to be a trio 


REG a 


C < 2) 

C(DEL) 
C(INS) 
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FILENAME: ALLPRPS.SET (.SET)(.FNT) 



REG 1 

REG 2 

REG 3 

REG a 


REG 1 

REG 2 

REG 3 

REG a 


SPACE 

C ( > ) 




@ 

c ( . ) 




i 

C ( A ) 




A 





H 

C ( B ) 




B 

t. 




« 

C ( C ) 




c 





$ 

C ( D ) 




D 

d 




1 

C ( E ) 




E 





&: 

C ( F ) 




F 

f 





C < G ) 




G 





( 

C ( H ) 




H 

h 




) 

C ( I ) 




I 





* 

C ( J ) 




J 





+ 

C ( K ) 




K 

K 





C ( L ) 




L 

1 





C ( M ) 




M 






C ( N ) 




N 





/ 

C ( 0 ) 




□ 





0 

C ( P ) 




p 





1 

C ( 0 ) 




0 





7 

C ( R ) 




R 





3 

C(S) 




s 





a 

C ( T ) 




T 





5 

C (U) 




u 





G 

C (V) 




u 





7 

C ( W > 




U 





8 

C (X) 









3 

C ( Y ) 




Y 






C ( Z ) 










ESC 


RETURN 


[ 

c ( ;) 




< 

C ( - ) 


SH DEL 


\ 





_ 

C ( = ) 


SH INS 


] 

SH ( < ) 


C(? ) 



C ( + ) 


C(TAB) 



BACK S 


c ( D E L ) 


? 

C < * ) 


SH TAB 



TAB 


C<INS) 


NOTE: “C" means CONTROL (CTRL) KEY and (character). 
"SH" means SHIFT KEY and (character). 

"INS" means INSERT KEY. 

"REG" means COLOR REGISTER. 


"DEL" means DELETE KEV 


Permission is Sranted to copy this p a 9 e onl; 
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ATARI Program Exchange 

P.O. Box 3705 

Santa Clara, CA 95055 


We’re interested in your experiences with 
APX programs and documentation, both fa¬ 
vorable and unfavorable. Many of our authors 
are eager to improve their programs if they 
know what you want. And, of course, we want 
to know about any bugs that slipped by us, so 
that the author can fix them. We also want to 


Review Form 

know whether our instructions are meeting 
your needs. You are our best source for 
suggesting improvements! Please help us by 
taking a moment to fill in this review sheet. 
Fold the sheet in thirds and seal it so that the 
address on the bottom of the back becomes 
the envelope front. Thank you for helping us! 


1. Name and APX number of program. 


2. If you have problems using the program, please describe them here. 




3. What do you especially like about this program? 


4. What do you think the program’s weaknesses are? 


5. How can the catalog description be more accurate or comprehensive? 


I 


6. On a scale of 1 to 10, 1 being “poor” and 10 being “excellent”, please rate the follow¬ 
ing aspects of this program: 

__ Easy to use 

_User-oriented (e.g., menus, prompts, clear language) 

__Enjoyable 

__ Self-instructive 

_Use (non-game programs) 

_Imaginative graphics and sound 


I 




7. Describe any technical errors you found in the user instructions (please give 
page numbers). 


8. What did you especially like about the user instructions? 


9. What revisions or additions would improve these instructions? 


10. On a scale of 1 to 10, 1 representing “poor” and 10 representing “excellent”, how 
would you rate the user instructions and why? 


11. Other comments about the program or user instructions: 


From 


STAMP 



ATARI Program Exchange 

P.O. Box 3705 

Santa Clara, CA 95055 


[seal here] 






MAPMAKER 

by Stephen W. Hall 

• Create multiscreen maps using col¬ 
or, fine-scrolling, and redefined 
character sets 

• Fit large maps into small amounts 
of memory 

• Store completed maps on diskette 

Whether you design computerized 
simulation games or just want to 
get the most from your ATARI Com¬ 
puter, you'll find Mapmaker a 
great programming tool. This easy- 
to-use utility can help you create 
multiscreen displays that capitalize 
on the ATARI Computer's out¬ 
standing multicolor, fine-scrolled 
redefined character sets. The large 
display that can fit into a small 
amount of memory is truly impres¬ 
sive. On systems with at least 40K 
of memory, Mapmaker makes up to 
8K available for displays compris¬ 


ing as many as 34 screens. 

To create a map with Mapmaker, 
you define the dimensions of the 
total display area, and then enter 
characters from the computer key¬ 
board. Mapmaker can act as an 
easel upon which you can try out 
different combinations of shapes 
by displaying them on the screen, 
and with fine scrolling you can 
move smoothly from one map area 
to another. Mapmaker comes with 
an all-purpose, map element 
character set and a sample eight- 
screen map. You can also use a 
separate character set editor (such 
as Instedit, available through APX) 
to create your own mapping 
characters and then produce an 
infinite variety of displays with 
Mapmaker. Mapmaker supports 
four character colors, plus a back¬ 
ground color, and comes with an 
easy-to-use facility for changing 
the playfield color registers. 


Requires: 

• ATARI BASIC 
Language 
Cartridge 


Diskette 

(APX-20144) 

• ATARI 810™ 
Disk Drive 

• 32K RAM 


Optional: 

• ATARI 
Joystick 
Controller 

• Instedit or other 
Compatible 
character set 
editor 



About the author 


STEPHEN W. HALL 


The idea for Mapmaker was born 
when Stephen Hall, of Arlington, 
Virginia, met Chris Crawford, 
author of APX's award-winning 
Eastern Front, at an ATARI users' 
seminar. As a war games enthusi¬ 
ast, Stephen was fascinated by 
the game's intricate screen dis¬ 
play. He reasoned that anyone 
who was going to create war 
games would need a good utility 


—and in writing one, Stephen 
could learn the technique for 
himself. His hobby has led him 
to a new career as a program 
developer for a software retailer. 
As computer games editor for Fire 
and Movement, a war games 
magazine, Stephen also writes 
regular reviews (including one 
praising Eastern Front as a 
ground-breaking achievement). 


Diskette: version 1 
Edition B 




